Shape-Related Functions Applicable to Pictures (IM: XG)

Inside Macintosh: QuickDraw GX Graphics /: Chapter 6 - Picture Shapes / Applying Functions Described Elsewhere to Picture Shapes

Shape-Related Functions Applicable to Pictures
You can apply all of the functions described in the chapter "Shape Objects" in Inside Macintosh: QuickDraw GX Objects to picture shapes. These functions allow you to

manipulate the shape object that represents the picture shape; for example, you can copy, clone, cache, compare, and dispose of the picture shape
set the geometry, shape type, shape fill, and shape attributes of the picture shape
change the style, ink, and transform objects that are associated with the picture shape
manipulate the picture shape's tags and owner count

Table 6-3 gives important picture-related information for a subset of the functions from the chapter "Shape Objects" of Inside Macintosh: QuickDraw GX Objects. Functions described in that chapter that do not appear in this list exhibit the same behavior when applied to picture shapes as they do when applied to other types of shapes.
Shape-related functions that exhibit special behavior when applied to pictures
Function name Action taken
GXCopyToShape Makes a copy of the picture shape; the items of the new picture shape reference the same shapes as the items of the original picture shape.
GXCopyDeepToShape Makes a copy of the picture shape, including a complete copy of the entire picture hierarchy.
GXGetShapeSize Determines the amount of memory currently used by all of the items in the picture.
GXGetShapeFill Returns the shape's shape fill, which for picture shapes is always even-odd fill or no fill.
GXSetShapeFill Sets the shape's shape fill; you must always set a picture shape's shape fill to even-odd fill or no fill.
GXSetShapeType Changes the shape type of the picture shape and converts the shape fill and geometry as appropriate. The resulting shape is a picture with one item--the original shape.

Shape-related functions that exhibit special behavior when applied to pictures
Function name	Action taken
GXCopyToShape	Makes a copy of the picture shape; the items of the new picture shape reference the same shapes as the items of the original picture shape.
GXCopyDeepToShape	Makes a copy of the picture shape, including a complete copy of the entire picture hierarchy.
GXGetShapeSize	Determines the amount of memory currently used by all of the items in the picture.
GXGetShapeFill	Returns the shape's shape fill, which for picture shapes is always even-odd fill or no fill.
GXSetShapeFill	Sets the shape's shape fill; you must always set a picture shape's shape fill to even-odd fill or no fill.
GXSetShapeType	Changes the shape type of the picture shape and converts the shape fill and geometry as appropriate. The resulting shape is a picture with one item--the original shape.